home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 4 / ETO Development Tools 4.iso / Essentials / MacApp Documentation / MacApp.TECH$ Archives / 1991 / Feb 91 / MacApp.Tech$ 2⁄8⁄91 / 2858-MacApp (lack of) doc-Feb91 < prev    next >
Encoding:
Text File  |  1991-03-06  |  2.2 KB  |  49 lines  |  [TEXT/GEOL]
  1. Item    1010867                         5-Feb-91        14:24PST
  2.  
  3. From:   TSD                             Encore, The Software Dept,PRT
  4.  
  5. To:     MACAPP.TECH$                    MacApp Technical
  6.  
  7. ------------------------------------------------------------------------------
  8.  
  9. Sub:    MacApp (lack of) document
  10.  
  11. Attn: MacApp Technical BBS
  12. SentBy: Ed Ruder
  13.           News via AppleLink™
  14. MacApp (lack of) documentation…
  15. TWIMC:
  16.  
  17. We have just started using MacApp (two month veterans), and are close to the
  18. end of our first MacApp app. We have been pleased with the aspects of Mac
  19. programming that are handled more or less automagically by MacApp, but we do
  20. have experienced several major headaches. Menus, scrolling, dialogs, undo,
  21. file i/o, and other areas are generally very easy to implement in MacApp.
  22. However, whenever we endeavor to implement something that is not described in
  23. the tutorial or cookbook, we end up spending hours or days pouring through the
  24. MA Examples and/or the abysmal MacApp reference materials trying to figure out
  25. the “right” way to do things. (For example, we tried for days to implement a
  26. virtual [disk-based, rather than RAM-based] document, couldn’t figure out how
  27. to do it using MacApp, and ended up writing it ourselves.)
  28.  
  29. In our opinion, while the tutorial, cookbook, and general reference for MacApp
  30. are good documents, there is NO good in-depth reference for MacApp which
  31. discusses, in detail, how all of the bells and whistles in MacApp “hang
  32. together.” We do have one document called “MacApp,” which contains lots of
  33. release notes, some good descriptions of TView, TApplication, TDocument, and a
  34. few other classes, but not nearly enough detailed discussion of all of the
  35. features of the classes, and how to properly use them. More often than not, we
  36. end up reading the header and/or source files to figure out stuff that isn’t
  37. covered in the tutorial/cookbook. The HyperCard stacks are somewhat helpful,
  38. but who wants to run HyperCard all of the time? Also, the stacks are good
  39. descriptions of the “trees;” what we have needed is a detailed description of
  40. the “forest.”
  41.  
  42. Anyone out there have similar gripes/insights? Anyone know of the kind of
  43. documentation that I am talking about?
  44.  
  45.  
  46. Ed Ruder
  47. The Software Department/Encore Systems
  48.  
  49.